home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 726-750 / 731 / qmouse / qmouse.doc < prev    next >
Text File  |  1995-03-18  |  8KB  |  240 lines
  1. QMouse V2.20
  2.  
  3. Written by Dan Babcock
  4.  
  5. -- This program REQUIRES Kickstart 2.0 or higher. --
  6.  
  7. I missed one program more than any other when I switched to
  8. Kickstart 2.0: QMouse, the venerable mouse-utility. I tried every
  9. other program of its type that I could find, but every utility I
  10. tried had quirks, lacked important features, and worst of all was
  11. HUGE. Discouraged (and annoyed), I decided to write my own.
  12. QMouse 2.0 (this program) is a completely new program, not an
  13. update to QMouse, but I couldn't think of a more fitting name;
  14. after all, my intent was to make a utility "like QMouse" - why
  15. not call it QMouse!? I hope this doesn't lead to too much
  16. confusion. On to the all-important feature list...
  17.  
  18. FEATURES:
  19.  
  20. * Automatic window activation after Amiga-M and Amiga-N: the
  21. previously active window will be made active. VERY useful!!! Does
  22. not poke screen structure like the original QMouse did (bad :-)).
  23.  
  24. * Optional top-line blanking for 2320/3000 owners who wish to
  25. mask the "half line flicker" effect. Does not blank the border,
  26. just the top line.
  27.  
  28. * System-friendly mouse blanking. Uses only the documented
  29. function SetPointer. Does not interfere with other sprites (e.g.
  30. JRComm's cursor).
  31.  
  32. * Mouse acceleration/threshold
  33.  
  34. * "PopCLI" feature. The CLI (actually any program may be
  35. executed) will have a sensible current directory, stack, and
  36. path.
  37.  
  38. * Click-to-front and click-to-back. New for V2.02: Click-to-Back
  39. will intelligently decide whether to perform a Window-To-Back or
  40. Screen-To-Back operation.
  41.  
  42. * SunMouse (activates window under mouse pointer). Personally I
  43. don't care for this feature, but if you like it, it's here.
  44.  
  45. * Screen blanking. No special effects; use another program for
  46. that stuff.
  47.  
  48. * NoClick - turn off drive clicking for any combination of
  49. drives.
  50.  
  51. * Can turn on the shell's *=#? feature (like "WildStar" etc.)
  52.  
  53. * Option to completely disable DisplayBeep (some programs overuse
  54. it and it gets VERY annoying!)
  55.  
  56. * Option to remap a few Northgate keys. (Note: Omnikey Ultra
  57. model)
  58.  
  59. * Starts own background process (no need to RUN).
  60.  
  61. * Written in assembly (efficient). Not a commodity.
  62.  
  63. * Fully public domain. Source code included.
  64.  
  65. * ONLY 3K !!!!!!!!!!!
  66.  
  67.  
  68. -------
  69. Changes
  70. -------
  71.  
  72. V2.02 -> V2.10
  73.  
  74. Adds a couple simple options (e.g. noclick and wildstar), and
  75. some internal changes permit left-amiga-cursor mouse movements to
  76. work with mouse blanking enabled. V2.10 was released on Fish 697.
  77.  
  78. V2.10 -> V2.20
  79.  
  80. Older versions (pre-2.11) of QMouse had a serious memory-trashing
  81. bug. This is fixed thanks to Chris Schneider.
  82.  
  83. The problem with the NoFlicker option and virtical overscan,
  84. reported by several people, has been fixed.
  85.  
  86. The "PopCLI" feature now brings the Workbench screen to the
  87. front.
  88.  
  89.  
  90. -----------------
  91. Using QMouse V2.0
  92. -----------------
  93.  
  94. To see the parameter template type "Qmouse ?". Most likely it
  95. looks like gibberish to you, though, so I'll explain the options:
  96.  
  97. (Please note: If you don't specify an option, the option is OFF.
  98. The default set of options is therefore all OFF, except for some
  99. basic features that don't have an option).
  100.  
  101. MBLANK (abbreviated M):
  102.  
  103. This specifies the number of seconds of mouse inactivity     
  104. before the mouse pointer is blanked. The mouse pointer is also
  105. blanked whenever you hit a key.
  106.  
  107. Side note: Many people claim that it is impossible to blank the
  108. mouse in a "system-friendly" way. They're wrong. :-)
  109.  
  110. Examples: m=3, mblank=9, M 10
  111.  
  112. SBLANK (abbreviated S):
  113.  
  114. Screen blanking - works same as mouse blanking basically. See
  115. "bugs" section for a possible (unconfirmed) bug.
  116.  
  117. NOFLICKER (abbreviated N):
  118.  
  119. This option will blank the top line of the display. (Only useful
  120. to 2320/3000 owners). This function inspects the system copper
  121. list, so it probably won't work in future Kickstarts.
  122.  
  123. Note: If a screen with extreme virtical overscan is being
  124. displayed, QMouse will automatically turn this feature off. To
  125. get rid of the flicker simply drag the screen down a few lines.
  126.  
  127. CMD:
  128.  
  129. Specifies the command to execute when the user hits left-Amiga-
  130. ESCape. Default is "newcli". Use like this: CMD="newcli
  131. con:0/0/640/400". Important!!! The current directory, stack, and
  132. path of the newly created CLI will be that of the CLI where
  133. QMouse was originally executed. Therefore, place QMouse in your
  134. startup-sequence *after* STACK and PATH commands!!
  135.  
  136. ACCELERATION (abbreviated A):
  137.  
  138. Specifies mouse speed-up factor. QMouse uses the same
  139. acceleration/threshold algorithm as DMouse, by the way (I got
  140. used to the feel).
  141.  
  142. Examples: acceleration 3, a=4, a 9
  143.  
  144. THRESHOLD (abbreviated T):
  145.  
  146. Specifies a threshold (minimum movement) required to apply
  147. acceleration factor. The default is zero. Example: T=1.
  148.  
  149. CLICKTOBACK (abbreviated CTB):
  150.  
  151. Specifying "ctb" or "clicktoback" will enable a feature whereby
  152. both mouse buttons being pressed simultaneously will send the
  153. window under the mouse pointer to the back, OR, if the mouse is
  154. not over a window, or if the window is a backdrop window, or if
  155. the window is the only non-backdrop window on its screen, then a
  156. screen-to-back operation will be performed instead.
  157.  
  158. CLICKTOFRONT (abbreviated CTF):
  159.  
  160. This option specifies the number of mouse clicks required to
  161. bring the window under the mouse pointer to the front. Example:
  162. ctf=2.
  163.  
  164. SUNMOUSE:
  165.  
  166. Specifying "sunmouse" turns on the "Sun Mouse" feature. I don't
  167. recommend you use it because it's annoying and causes problems
  168. with some programs. (Unless you happen to like it :-)).
  169.  
  170. NOBEEP:
  171.  
  172. Completely disables DisplayBeep (the routine that flashes the
  173. screen).
  174.  
  175. NORTHGATE:
  176.  
  177. For Northgate Omnikey Ultra keyboard users only: remaps a couple
  178. keys. (Page Up -> Shift-Cursor-Up, etc). Sorry, if you want to
  179. change it you'll have to edit the source and reassemble.
  180.  
  181. NOCLICK:
  182.  
  183. Turns off drive clicking option in trackdisk, just like many 2.0-
  184. only 'noclick' programs. The argument to this option is a decimal
  185. number whose (4-bit) binary equivalent corresponds to what drives
  186. should receive the noclick treatment. For example, the number 3
  187. is "0011" in binary, and means drives 0 and 1 (but not 2 and 3)
  188. should be NoClick'ed. To turn off clicking on all drives, specify
  189. NOCLICK=15. Note: This is a toggle.
  190.  
  191. Important: If you drive makes funny clicks after using NoClick,
  192. reboot immediately - you can damage a drive that doesn't support
  193. NoClick (which is why the OS defaults to the "clicking" mode).
  194.  
  195. VERIFY:
  196.  
  197. Toggles the floppy disk verify feature of Hackdisk (my
  198. trackdisk.device replacement). If you aren't using Hackdisk this
  199. option is useless. (Actually it's probably useless even if you
  200. ARE using Hackdisk since verify should always be on :-)).
  201.  
  202. STAR:
  203.  
  204. Toggles the *=#? shell feature, similar to programs called
  205. "WildStar" etc.
  206.  
  207. QUIT:
  208.  
  209. Completely de-installs QMouse. Note that executing QMouse when
  210. already installed will cause a QUIT to happen first. Due to
  211. extensive SetFunction-ing of the OS, this is considered unsafe.
  212. So please, use only for initial testing (i.e. deciding what
  213. features of QMouse you like and which you don't, etc). Once
  214. you're happy, put QMouse in your startup-sequence and don't mess
  215. with it.
  216.  
  217. Important: If you run another program that SetFunctions some of
  218. the same routines (for example ARQ) you will not be able to QUIT
  219. or modify parameters. Future versions of QMouse may handle this
  220. better.
  221.  
  222. ----
  223. Bugs
  224. ----
  225.  
  226. A user reported that using the screen blanking caused system
  227. clock problems. One possible explaination is that the crude
  228. method of screen blanking (turning off display DMA) might be
  229. excluding virtical blanking interrupts. I haven't been motivated
  230. enough to investigate, so I can't confirm this report. If it's a
  231. problem, by all means use another program for screen blanking.
  232.  
  233. ----------
  234. The Author
  235. ----------
  236.  
  237. If you want to contact me for some reason, please send email to
  238. Dan_E_Babcock@cup.portal.com. Thanks to those nice folks who sent
  239. feedback.
  240.